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CARDRAM/16" - INSTRUCTIONS 



GUARANTEE 
********* 

For as long as this product is owned by its 
original owner, CARDCO, Inc. will repair or 
replace any defective parts or the entire 
unit if it should become inoperative due to 
a defect in manufacture or materials, pro- 
viding the unit is returned to CARDCO, Inc. 
in undamaged condition with proof of pur- 
chase (purchase receipt) . 



This product was developed by: 

CARDCO, Inc. 

313 Mathewson 

Wichita, Ks. 

67214 

(316) 267-6525 



THIS WARRANTY IS LIMITED TO LIABILITY FOR 
THE PRODUCT ONLY, AND CARDCO, INC* WILL NOT 
BE RESPONSIBLE FOR DAMAGE TO OR LOSS OF ANY 
ASSOCIATED HARDWARE OR SOFTWARE CAUSED BY 
THE USE AND/OR MISUSE OF THIS PRODUCT. 
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CARDRAM/16 n - INSTRUCTIONS 



WARNING 
******* 



NEVER ATTEMPT TO INSTALL OR REMOVE THE 
"CARDR AM/16" WITHOUT FIRST TURNING OFF THE 
VIC-20 POWER SWITCH. 



NOTE: Within the program listings in this 
manual these codes are used to make 
the program listings more readable. 



LISTING CODES: 



<cu> 


CURSOR UP 


<CD> 


CURSOR DOWN 


<CL> 


CURSOR LEFT 


<CR> 


CURSOR RIGHT 


<HM> 


CURSOR HOME 


<SC> 


SCREEN CLEAR 


<RV> 


REVERSE ON 


<RO> 


REVERSE OFF 


<ID> 


INSERT KEY or DELETE KEY 



<cc> 



COLOR CHANGE 
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CARDRAM/IS" - APPENDIX 



DON'T FORGET THE RULES: 
*********************** 



TURN OFF YOUR VIC WHEN CHANGING CARTRIDGES 



YOU CAN'T PUT TWO THINGS IN THE SAME PLACE 



WHEN ALL ELSE FAILS READ THE INSTRUCTIONS 
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NOTICE: 

This is the most accurate information 
available we have at this time. As new games 
and utilities become available they may re- 
quire different memory locations than those 
listed here. With some creativity on your 
part you should be able to utilize them with 
most of the newly introduced VIC equipment. 
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Well, you bought it! What do you do with it? 
******************************************** 

The first thing you will need to do is 

put the board into your VIC* You should have 

no problem. However, if you do please feel 

free to call our office at (316) 267-6525 

between the hours of 1 PM and 5 PM CST. 

To start you off in the right direc- 
tion, use a ball point pen and turn on the 
RAM 1 - BLOCK 1 and the RAM 2 - BLOCK 2 dip 
switches on the "CARDRAM/16". (refer to the 
diagram on page # 14). Then, turn off your 
VIC-20 and: 

** If you are not using an expansion board: 

Plug the "CARDRAM/16" into the back of your 
VIC into the same place you would normally 
plug a game cartridge. Plug the cartridge in 
with the switches up, center the board 
carefully then firmly push it into position. 

** If you are using an expansion board: 

Remove all other cartridges from the board, 
orient the "CARDRAM/16" so that the switches 
are facing the computer, and then plug the 
"CARDRAM/16" into the slot on the board 
closest to the computer (so you can get at 
the switches for use when needed) . If your 
expansion board has switches be sure that 
the switch that controls that slot is turned 
on, or on our "CARDB0ARD/3s" or our 
"CARDBOARD/6" be sure that dip switch # 7 is 
in the on position. 
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'CARDRAM/16" - APPENDIX 



PROGRAMMER'S AID: 

This cartridge resides in BLK 3 and 
will require that you not use RAM in BLK # 3 
or VIC-MON. 



VIC-MON MACHINE LANGUAGE MONITOR: 

This cartridge resides in BLK 3 and 
will require that you not use RAM in BLK # 3 
or Programmer's Aid. 



HES MON MACHINE LANGUAGE MONITOR: 

This cartridge resides in BLK # 5. 

HES WRITER WORD PROCESSOR: 

This cartridge resides in BLK # 5. 

QUICK BROWN FOX WORD PROCESSOR: 

This cartridge resides in BLK # 3. 

VIC-TREE PROGRAMMERS UTILITY CARTRIDGE: 

This cartridge uses both BLK # 3 and 
BLK # 5. 
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**** INTERNAL DIP SWITCH #4: Locates the RAM 

in memory BLK 1. 

This will give you 11775 BYTES FREE. 



**** INTERNAL DIP SWITCH #3: Locates the 
to memory BLK 2. To be used by basic 
block will require an 8K RAM in BLK # 1. 
This will give you 19967 BYTES FREE. 



RAM 
this 



**** INTERNAL DIP SWITCH #2: Locates the RAM 
to memory BLK 3 . To be useable by basic you 



must have 8K RAMs in BLK 
This will give you 28159 
This will also prevent 
MOM or Programmer's Aid 



1 & BLK 2. 
BYTES FREE, 
you from using 



VIC- 



**** INTERNAL DIP SWITCH #1: Locates the RAM 
to memory BLK 5. It is not useable for basic 
programming. RAM cannot be used in BLK # 5 
if you are using Super Expander or auto- 
start game cartridges 



COMMODORE 16k RAM EXPANSION: 

This unit contains two separate 8k RAM 
groups that are permanently assigned to 
block # 1 and block # 2. 



PLUG-IN GAMES: 

All plug-in games that start up auto- 
matically will be addressed to BLK # 5. Some 
games may also use combinations of several 
other blocks. Trial and error will help you 
determine where a particular game resides, 
because we cannot possibly give you all that 
information in this manual. 
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Now turn on your computer and see if 
the start up message on your screen includes 
the number "19967 BYTES FREE." If * the number 
does not equal this number repeat the steps 
outlined above exactly as stated and check 
the number again. 

If you cannot get past this step please 
contact your dealer or call our customer 
service department at (316) 267-6525 between 
the hours of 1 PM and 5 PM C.S.T. Mon-Fri. 

Once you have completed this step you 
may want to type in and run the MEMORY TEST 
PROGRAM as listed on page # A12. 

If you are not using an expansion board 
of any kind a lot of the following informa- 
tion will be of only passing interest, but 
you should read it anyway because it has a 
wealth of information about your computer 
and how it operates. 



PAGE 5 



"CARDRAM/ie* - INSTRUCTIONS 



SOME VALUABLE TECHNICAL INFORMATION 
*********************************** 

It is a law of nature that you cannot 
have two things in the same place at the 
same time. This is also true of memory in 
the VIC-20. You cannot have two things in 
the same memory location at the same time. 

Everything that you plug into your 
computer takes up space in the computer's 
memory map. (Refer to the mini-memory-map on 
page 8) The "CARDRAM/16" requires two memory 
blocks and if you already have something in 
one of those blocks neither of the items 
will function correctly, 

O.K. So how do you find out what car- 
tridges go in which block? Turn to the ap- 
pedix at the rear of this booklet for a 
listing of some of the cartridge assignment 
locations. 

A little trial and error won't hurt. 
The VIC-20 won't blow up if you put in the 
wrong cartridges, all that will happen is 
that when you turn the power on your VIC 
will lock up and you won't be able to use it 
until you turn it off, correct your errors 
an apologize profusely. 

There are seven blocks or areas of 
memory that are not used by the internal 
workings of your VIC-20. These blocks are 
made available to the user through the mem- 
ory expansion port (remember, the place 
where you plug in games, etc.). 
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TO THE BEST OF OUR KNOWLEDGE WHAT GOES WHERE 
******************************************** 



THIS SECTION IS DESIGNED TO TELL YOU WHAT 
RAM BLOCKS ARE USED BY OTHER CARTRIDGES SO 
AS TO AVOID CONFLICTS WITH THESE CARTRIDGES. 



3K RAM EXPANSION: 



Goes in RAM 1, RAM 
special requirements; its 
matic. But, remember ..• it 
in the bytes free total 



2, & RAM 3. No 
access is auto- 
will not add up 
in the power up 



message with the H CARDRAM/16" installed. 



SUPER EXPANDER: 

Same as 3k RAM, and it also occupies 
BLK # 5 as an auto start ROM, so it auto- 
matically comes on line when you turn on 
your VIC-20. Use of this cartridge will 
prevent you from using RAM in BLK # 5. It 
also will subtract 136 bytes from your start 
up bytes free message if you have 8k or more 
of RAM added to your VIC. 



COMMODORE 8K RAM EXPANSION: 

There is an internal dip switch inside 
the case of each of these cartridges. Refer 
to the instruction sheet that comes in the 
cartridge box. This internal switch group 
can have only one switch on at a time. 
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190 REM GAME SIMULATOR BY BRECK RICKETTS 

118 REM 16K MEMORY MUST BE IS BLOCKS 2,3 

128 M=l 6384: PRINT" (SO <XD}<CRXCRXCR> GAME 

SIMULATOR" 

1 30 I FPEEK< 40964) <>650RPEEK< 40965) 048THEN 

PRINT" {RVXCD) <CC> <XR>NO GAME IN BLOCK 5CCO" 

:END 

140 POKE 16384, 76: IF PEEK< 16384) 076THENPRINT" 

CCDXCRiXRVXCONO RAM IN BLOCK 2<CO" :END 

158 P0KE24576, 76: IF PEEK< 24576) 076THENPRINT" 

<CDXCR:XRV>tCON0 RAM IN BLOCK 3CCO" :END 

160 READA:IFA=-1THEN180 

1 78 POKEM , A : M=M+ 1 : B=B+ A : GOTO 1 60 

180 IFB012292THEN PRINT" {SOtCDXCRXRVXCO 

BAD DATA STATEMENTS C CO" :END 

190 PRINT" <SC>{CD><:CR>SYS <RU>16384<:R0> TO 

SAVE" 

200 PRINT" <CD>{:CR}SYS CRM>16453<:R0> TO LOAD" 

210 PRINT" <CR)WITH NO NAME" 

220 PRINT" <CDXCR>SYS <RU>16460<RO> TO LOAD" 

230 PRINT" <CR>UIITH NAME" 

240 PRINT" CCDXCR>POKE 17000,X FOR NAME<XD> 

CCD>" 

250 DATA1 69, 0,1 33, 0,1 68, 133, 2, 169, 160, 133,1 , 

169,96,133,3,177,0,145,2,230,0,230,2,208 

260 DATA246 , 230 , 3 , 230 , 1 , 1 65 , 1 , 20 1 , 1 92 , 208 , 236 

, 1 69 , , 1 33 , , 1 69 , 96 , 1 33 , 1 , 1 62 , , 1 60 , 1 28 , 1 69 

270 DATA1 , 1 33 , 1 86 , 1 69 , 1 04 , 1 33 , 1 87 , 1 69 , 66 , 1 33 , 

1 88 , 1 69 , 1 , 1 33 , 1 83 , 1 69 , , 32 , 1 1 7 , 246 , 96 , 1 69 

280 DATA© , 1 33 , 1 83 , 76 , 88 , 64 , 1 69 , 1 4 , 1 33 , 1 87 , 

169,66,133,188,169,1,133,133,169,1,133,186 

290 DATA 1 33 , 1 85 , 1 62 , , 1 60 , 96 , 1 69 , , 32 , 66 , 245 , 

96,-1 
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The seven memory blocks are: 



RAM 1) These three blocks are usually 
RAM 2) treated as one unit. Each is Ik in 
RAM 3) size and they are located below the 
internal 5k of RAM that is included 
with the VIC-20. Increases memory to 
6500+ BYTES FREE total. 



BLK 1) This is the first 8k expansion area 
Increases RAM to 11000+ BYTES FREE. 

BLK 2) This is the 2nd 8k expansion area. 
Increases RAM to 19000+ BYTES FREE. 

BLK 3) This is the 3rd 8k expansion area. 
Increases RAM to 28000+ BYTES FREE. 

BLK 5) This is the last 8k expansion area. 
Will not increase user basic RAM. 



The "CARD RAM/16" may occupy any two of the 
BLKs listed above as 8k expansion areas. 



NOTE: Refer to mini-memory-map, figure #2. 
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'CARDRAM/16 11 - APPENDIX 



MINI MEMORY MAP 



DECIMAL 
ADDRESS 


HEX 

ADDRESS 


INTERNAL VIC 
MEMORY RAM/ROM 
LOCATIONS 


ACCESSED VIA 
MEMORY EXPANSION 
PORT 


0000 TO 
0928 


50000- 
S033B 


ZERO PAGE 

& WORKING RAM 




0928 
1023 


$033C 
$03FF 


CASSETTE 
BUFFER 




1024 
4095 


$0400 
SGFFF 




3K EXPANSION RAM 
RAM#1,RAM#2,RAM#3 


4096 
8191 


$1000 
$1FFF 


INTERNAL USER 
RAM & SCREEN RAM 


8192 
16383 


$2000 
$3FFF 




8K EXPANSION RAM 
BLK < 1 


16384 
24575 


$4000 
$5FFF 




8K EXPANSION RAM 
BLK < 2 


24576 
32767 


$6000 
$7FFF 




8K EXPANSION RAM 
BLK # 3 


32768 
36863 


$8FFF 


GENERATOR ROM 




36864 
40959 


$9000 
$9FFF 


VIC CHIP, I/O 
6 COLOR RAM 




40960 
49151 


$A000 
$BFFF 




8K EXPANSION RAM 
BLK # 5 


49152 
65535 


$C000 
$FFFF 


KERNAL ROUTINES 
AND BASIC 
INTERPRETER ROM 

FIGURE 1 2 

********** 


• 



(SYS 64802 for those who do not have a reset 
button) then use your computer like the 
cartridge is a ROM and follow the same in- 
structions for using it. (ie. sys 6*4096 to 
enable VIC-MON) . 

If the cartridge was a block # 5 car- 
tridge you must switch off RAMI BLOCK # 3 
and switch on RAMI BLOCK # 5. Then press the 
reset button (or SYS 64802), if the car- 
tridge was designed as an auto-start type 
you should be under way r otherwise follow 
the cartridge's directions to enable it. 



We know some games won't run, 
once and then bomb 
just fine, TRIAL 
hope. 



some run 
(OMEGA RACE) and most run 
AND ERROR is your only 



Just for your information, making 
copies of a program you do not own is 
against the law. So is giving copies of 
programs you own to persons who do not own 
an original of the same program. Therefore, 
use this program for your personal benefit 
and educational advancement. 



NOTICE: If you want to save 
these routines will not work. 



to the disk 
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If you get a BAD DATA ERROR you typed 
in some of the data statements wrong. If not 
your screen will display your options. At 
this point you will wish to save the pro- 
gram. If you intend to put more than one 
program on a tape you can save each program 
with a name. To exercise this option simply 
POKE any number from to 255 into location 
17000, this becomes the program name and it 
will show up as the ASCII character of the 
number you chose (65=A f 66=B, etc.) 

Now, type SYS 16384 to save the car- 
tridge. Your program will now be saved to 
the tape. 



In the case of a block 
follow the instructions as abo 
you should not enable (turn 
tridge you want to save until 
and run the program and then 
get to the SYS prompts should 
off the RAMI BLOCK # 3 sw 
"CARDRAM/16" and then turn on 
the cartridge you wish to save 
the cartridge type SYS 16419. 



# 3 cartridge 
ve except that 
on) the car- 
after you load 
only when you 
you then turn 
itch on the 
the switch for 
. Now to save 



When ever you want to use 
now all you need to do is be 
have your "CARDRAM/16" switches 
BLOCK # 3 and RAM2 BLOCK # 2. 
the game simulator, then at the 
POKE 17000, the program name 
255). Then SYS 16460 to load 



gram, or SYS 
on the tape. 



16453 to load the 



the program 
sure that you 
set to RAMI 
Load and run 
SYS prompts, 
value (0 to 
a named pro- 
next program 



If the cartridge was originally in 
block # 3 you are ready to go. You can re- 
assign RAM2 to BLOCK # 1 and press reset 
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As you may have noticed, the 8k Blocks 
are numbered 1, 2, 3, 5. What happened to #4 
??? Well, Commodore decided to use that 
location for some internal workings, and 
thereby made it unavailable for us to use. 
This also puts BLK 5 in an awkward position, 
because basic only "sees" memory that is in 
a continuous string. BLK 5 cannot be used 
for basic programming because it is sepa- 
rated from the rest of the RAM blocks by BLK 
4. But not to worry — if you put 8k of RAM 
there, it is still useable as a storage area 
for machine language program as well as 
storage for various data. When data is 
stored up there, it is very safe, because 
basic cannot overwrite it. In fact, the only 
way to get at it is with a "SYS" command or 
a "PEEK" or "POKE". More on that later. 

If you have an 8k RAM in BLK 1 and a 3k 
or or super expander in RAM 1, RAM 2, and 
RAM 3 memory areas, these RAM blocks also 
become unuseable for basic programming be- 
cause it is separated from the rest of basic 
ram by the screen ram (the area of ram the 
VIC-20 uses to store the information on the 
screen). And it, just like BLK #5, becomes 
useable for machine language programming and 
storage of data only because it is not in a 
continuous line with the rest of the RAM 
memory that basic uses. (The screen is now 
between the 3k area and the rest of basic 
RAM) 

Have I got you confused yet? 

See if this helps. 
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THE MYSTERIOUS MOVING SCREEN 
**************************** 



Now is the time to tell you about "THE 
MYSTERIOUS MOVING SCREEN"! You may have been 
warned by some (tape-based) software sup- 
pliers that THIS PROGRAM WILL ONLY RUN ON 
VIC-20's WITH NO ADDITIONAL MEMORY INSTALLED 
Or you may have tried to load a program from 
a tape when you had your 16k RAM cartridge 
in place and found it didn't work, or had 
some really weird goings-on happening on the 
screen. The reason is that when you put an 
8k or 16k RAM in the VIC's BLK #1 location 
and turned on the VIC, the screen RAM is 
moved to a new position, (Refer to figure 3 
to see what happens.) 



A well written program will not be af- 
fected by the amount of memory you have, but 
for those of you who own some poorly written 
programs, and for those of you who want to 
write good programs we offer these solutions 
to the problem. 
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GAME SIMULATOR 
************** 



At times it would be nice to be able to 
save a game or utility cartridge from it's 
cartridge format to tape format. This pro- 
gram will allow you to save a cartridge from 
BLOCK # 5 or BLOCK # 3 to tape and then re- 
load the program and run it. Be aware how- 
ever that some cartridges use protection 
schemes that preclude this process but it 
will work on most cartridges. Also, some 
cartridges use both blocks 3 & 5, these will 
require a little more work but they can be 
used as well. First let's cover a block # 5 
cartridge save. 



To use this program first type in 
save the program. Now you will need an 
pansion board like our "CARDB0ARD/3s" . 
off your VIC, plug the cartridge you wa 
save into the board being sure that the 
that this cartridge is in is turned off 
the switches on the "CARDRAM/16" to a 
RAMI to BLOCK # 3 and RAM2 to BLOCK # 
plug it into the expansion board in 
sition that will allow you to get at 
switches as you will need to change 
later, and be sure that the slot this 
tridge is in is turned on. 



and 
ex- 
Turn 
nt to 
slot 
. Set 
ssign 
2 and 
a po- 
the 
them 
ear- 



Now turn on your VIC, you should get 
the power up message of 3558 BYTES FREE. 
Turn on the switch or switches that will 
turn on the slot that the cartridge you wish 
to save is in. Load the program you saved 
earlier and run it. 
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108 REM MEMORY CHECK BY BRECK RICKETTS 

110 REM16K OF RAM SHOULD BE IN BLOCK 1 AND 2 

120 PRINT" <SCXCDXCRXCR>CCR> 16K MEMORY 

CHECKCCD}" :P0KE81 92,76 :POKEl 6384, 76 

130 IF PEEK(8192)<>76 THEN PRINT" {CRKCRXRV} 

CCONO RAM IN BLOCK KCD> n 

140 IF PEEK< 16384)076 THENPRINT" <CR>CCRXRV> 

CCONO RAM IN BLOCK 2<CD>" 

150 PRINT" CCD>CCR}<:CR>{CR>RUNNING CHECK" 

155 M=828 

160 READA:IFA=-1THEN180 

170 P0KEM,A:M=M+1 :B=B+A: GOTO 160 

180 IF B09738THEN PRINT" {COCRVXCDKCRMCR} 

error in data<cdmclmcl><cl><cl:kcl><:cl><cl> 

£CLKCLKCL><CLUCL>STATEMENTS<CC> n :END 
190 SYS828:A=PEEK<2)+PEEK<3)*256 

IFA=0THENPRINT"£CC}" ; :6OTO200 

PRINT" {CO" 5 

PRINT"<RV}{CD}"A"<RO>ERRORS IN 2" 

print" <:cdxcrxcr>ccr><:cr><cr>passes OR" 

PRINT " {CD ><:RU>" A/2" CRO> ERRORS PER PASS 
END 



195 
196 
200 
210 
220 
{CO" 



230 DATA120, 169, 0,1 33,0 ,168, 133,2, 133, 3, 169, 

32,133,1,169,170,145,0,177,0,201,170,208 

240 DATA45, 230, 0,208, 242, 230,1 , 165, 1 ,201 ,96, 

208,234,169,0,133,0,169,32,133,1,169,85 

250 DATA1 45, 0,177,0,201 ,85,208,21 ,230,0,208, 

242,230,1,165,1 ,201,96,208,234,88,96,234 

260 DATA32,141 ,3,76,84,3,32, 141 ,3,76, 1 14,3, 

230,2,208,2,230,3,96,0,-1 

270 REM LINE 130,140,196, CC=RED 

280 REM LINE 180 CC=RED,BLUE 

290 REM LINE 220 CC=BLUE 

300 REM LINE 195 COGREEN 
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SOLUTION #1. There is a program at the end 
of this booklet which will put the screen 
back at its original position and relocate 
basic to start above the screen RAM area. 
This will allow you to use up to 24k of RAM 
for basic programming with these poorly 
written programs; and it has the side bene- 
fit of protecting the RAM area below the 
screen from being overrun by basic, and that 
is the area where you store the special 
characters you design for your own games. 
Or you can store machine language sub- 
routines there without fear of destruction 
or using any of basic' s memory area. 



SOLUTION #2. Additionally, there is a set of 
statements that will allow you to preprogram 
any programs that you write to run in any 
VIC memory configuration: 

Make this one of your first program lines: 

S = 4 * (PEEK (36866) AND 128) + 64 * 



(PEEK (36869) AND 112) 
(PEEK (36866) AND 128) 



C = 37888 + 4 * 



You can now peek or 
matter where it is) 
as the start of the 
and C as the start 
cations. For exampl 
location on the thi 
(S-start of screen, 
because each line i 
3*22 = 66, and the 3 
cause the first po 
second position is 1 



poke to the screen (no 
by using the variable S 
screen memory locations 
of the color memory lo- 
e the third character 
rd line would be S+68. 
and 68 is the 3rd line 
s 22 characters long so 
rd character adds 2 be- 
sition is the 0, the 
etc.) 
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THE MYSTICAL MOVING SCREEN 
************************** 

VIC-20 VIDEO RAM MEMORY MAP 



MEMORY LOC WITH LESS THAN 
HEX DEC 8K OF RAM 



WITH 8K OR MORE 
OF RAM ADDED 



$0400 1024 START OF BASIC 

WITH 3K EXP. RAM, 

$1000 4096 START OF BASIC START OF SCREEN 
WITH NO EXP. RAM. MEMORY 



$1200 4608 

$1E00 7680 START OF SCREEN 

$1FFF 8191 END OF MEMORY 

$3FFF 16383 

$5FFF 24575 

$7FFF 32767 

$9400 37888 

$9600 38400 START COLOR RAM 



SYART OF BASIC 

END INTERNAL RAM 
END BLK # 1 RAM 
END BLK # 2 RAM 
END BLK # 3 RAM 
START COLOR RAM 



FIGURE # 3 
********** 
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MEMORY CHECK 
************ 



This program will test all RAM 
located in memory BLOCK # 1 and BLOCK 
This is an easy check of a complete 8k 
16k memory cartridge. It will inform you 
the presence of either 8k or 16k and 
faulty memory locations will show up 
errors on the display. 



memory 
2. 
or 
of 
any 
as 



This is 
checks every 
manding test 



a tv/o pass test that load 

location twice. For a mor 

you can change the END i 



220 to a GOTO 190. This will create 
that will test and display memory unt 
stop it with the RUN/STOP key. This 
test the RAM cartridge constantly and 
you to watch the display for any erro 
normal error rate for a good RAM car 
should be less than one error in 
10,000 passes. The loop takes less th 
second so we would expect less tha 
error every three hours. That is an 
rate of less than .000008%. 



s and 
e de- 
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leeee rem memory map by breck ricketts 

16016 Y*«"<CD>CCR><CR)CCR>CCR>CCR> B :Z*° B ee*T*fT^-: PRINT" <SC> CCO "; 

18828 PRINTY*-SCe"Z* 

18838 PRINTYS-^Ae-Z* 

18848 PRINTY» - *88-Z* 

18858 PRINTY^-<<S8"Z» 

18868 PRINTY*"*4e ,, Z* 

18878 PRINTY^**28"Z* 

18888 PRINTY*"*1E"Z* 

18898 PRINTY*"*12"Z* 

18188 PRINTY*"*16"Z* 

18118 PRINTYS-sei-Z* 

18128 PRINTY*"*88 - Z* 

1 8 1 38 PRINT" <HM> (CD> " J 

18148 Z5=PEEK(43>*PEEK<44)*256sZ6=PEEK<55>+PEEK(56>*256 

18158 Z 1=48964 :Z2=1 68 xGOSUBl 8348 

18168 PRINTY*"<CC>I/0 " 

18178 Z 1=24582 :Z2=96:G0SUB1 8348 

18188 21=16421 :Z2=64:G0SUB1 8348 

18198 21=8288 :Z2=32:G0SUB1 8348 

18288 Z7=4« (PEEK (36866) AND 128) +64* (PEEK (36869) AND 1 12) 

18218 IFZ7=7688THENPRINTY**€COSCREEN" : GOTO 18238 

18228 PRINTY*" CCO BASIC ■ 

18238 PRINTY^CCOBASIC" 

18248 IFZ707688THENPRINTY* ,, €CC>SCREEN" :G0T018268 

18258 PRINTY*-(COBASIC- 

18268 REM 

18278 P0KE2888 ,76: I FPEEK( 2888 )=76THEN1 8298 

18288 PRINTY*"<CC>N0NE":G0T018318 

18298 IFZ5<1188THENPRINTY*-<CC>BASIC":G0T0183ie 

18388 PRINTY*" {CORAM " 

18318 PRINTY*-<CC>IRAM ,, 

18328 GETZ^tIFZ^=""THEN18328 

18338 PRINT- CCCXSO" i RETURN 

18348 Y*="<CD>CCRXCRXCRXCR>(CR><CRMCRXCRXCR><CRXCR><RV>" 

18358 IFPEEK(Z1)=65ANDPEEK(Z1+1)=48THENPRINTY*-{CC>GAME-:RETURN 

18368 P0KEZ1,76:P0KEZ1 + 1,76:IFPEEK(Z1>*76ANDPEEK(ZUI)=76THEN18388 

18378 G0T018488 

18388 IF2KZ6THENPRINTY*"(CC)BASIC" : RETURN 

18398 PRINTY*"<CC>RAM -:RETURN 

18488 IFPEEk(Zl)(>Z20RPEEK(Zl + l)OZ2THENPRINTY«-CCC)CART-:RETURN 

18418 IFPEEK(Z1)=Z2THENPRINTY*"<CC>N0NE* 

18428 RETURN 

18438 REM LINE 18818,18168,18318,18338 CC=BLUE 

18448 REM LINE 18218,18248,18358 CORED 

18458 REM LINE 18228,18238,18258,18298,18388,18388,18398 CC«GREEN 

18468 REM LINE 18488 CC=PURPLE 

18478 REM LINE 18288,18418 CC=CYAN 

18488 REM LINE 18818 THE 'MUSHROOM' IS A SHIFT C 
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"CARDRAM/16" FUNCTIONS AND OPERATIONS 
************************************* 



The 
equivalent 



"CARDRAM/16" is the 
of two seperate 8k 



functional 

RAM car- 



tridges, in one cartridge, 
block) can be assigned to 
RAM expansion areas that 
the VIC-20. If you don't 
just said return to page 
section again. 



Each 8k group (or 

any of the four 8k 

are available in 

understand what I 

6 and read that 



The block assignments are shown on the 
case of the "CARDRAM/16". (see page #14). 
You can turn blocks off and on with power on 
on the computer so as to allow physically 
moving memory from one location to another. 

For example if you had used the program 
on page # A3 to relocate the screen and 
basic, then you loaded in a basic program 
(the program must be less than 8k long) with 
the "CARDRAM/16" RAM 1 BLOCK 1 switch on and 
all other switches off. You could then 
switch off RAM 1 BLOCK 1 (this makes that 
block of memory unavailable to the computer, 
but leaves it intact) , switch on RAM 2 BLOCK 
1 and load another basic program into it. 
Now you can switch back and forth between 
two basic programs in memory by simply 
turning one off, turning the other one on 
and pressing the run/stop and restore keys 
at the same time. Word of caution - Do not 
attempt to switch the switches while a pro- 
gram is running. Stop or break the program 
before switching the switches. 
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Another example of switching memory is 
used with the program on page # A16, in 
which you will actually move a machine lan- 
guage program from BLOCK # 3 to BLOCK # 5 
where it needs to be to run correctly. 



To do this all you need to do is turn 
off the applicable switch, then turn on the 
switch for the RAM area that you wish to put 
that block of memory in. So the "CARDRAM/16" 
allows you almost unlimited use of memory in 
the VIC-20. You can use three or more 16k 
cartridges by simply selecting on or off the 
ones you need at a given time. 




CONTROLS WHICH AREA 

IN THE VIC MEMORY 

RAM 2 (8K BLOCK) 

WILL BE ASSIGNED TO 



CONTROLS WHICH AREA 

IN THE VIC MEMORY 

RAM 1 (8K BLOCK) 

WILL BE ASSIGNED TO 
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MEMORY MAP 
********** 



This program will simply tell you (by a 
graphic display on the screen) what memory 
configuration is present in your computer at 
any time. To use this program you should not 
have any program in memory as some of the 
program could be altered. (However programs 
in an unexpanded VIC may use this program as 
a gosub routine) Enter the program (making 
note of the REMs at the end of the program 
to assist you in entering the proper char- 
acters) as written for use as a gosub in an 
unexpanded VIC. To use this as a stand alone 
program change the RETURN in line 10380 to 
an END. 

Now SAVE the program for future use. 
Run the program and it will display the 
complete memory allocation of your VIC it 
will even tell you if you have external 
games, extra. RAM, or empty memory blocks 
that you can use for future expansion. 

The program will also show you where 
your screen RAM is located, and where basic 
program RAM area starts. You can then com- 
pare this directly with the memory maps that 
appear in this manual. Try different con- 
figurations of memory and actually see on 
the screen what is happening inside your 
VIC. 
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SPECIAL TERMS AS USED IN THIS MANUAL 
************************************ 



100 REM BASIC PROGRAM SWAP BY BRECK RICKETTS 

110 M=41216:PRINT M <SC>LOADING{CD>" 

120 READA:IFA<0THEN140 

130 POKEM,A:M=M+l :B=B+A: GOTO 120 

140 IFB=25096THENPRINT"GOOD LOAD" : GOTOl 60 

150 PR I NT "BAD DATA STATEMENTS" : END 

160 PRINT" <CD>SYS 41216 TO ENABLE" : NEW 

170 DATA120,! 69, 104, 141, 20, 3, 169, 161, 141, 21, 

3,120,169,0,133,0,169,16,133,1,169,0,133,2 

180 DATA1 69, 163, 133, 3, 169, 0,1 68, 177, 0,1 45, 2, 

230,2,230,0,208,246,230,3,230,1,165,1,201 

190 DATA30, 208, 236, 234, 165,45,141 ,0,162,165, 

46.141.1.162.165.47.141.2.162.165.48.141 .3 
200 DATA162, 165,49, 141 ,4,162,165,50,141,5,162 
,165,51 ,141 ,6,162,165,52,141 ,7,162,165,53 
210 DATA1 41, 8, 162, 165, 54, 141, 9, 162, 88, 96, 234, 
165,203,201,39,240,4,234,76,191 ,234,120,32 
220 DATA1 59, 255, 165,203,201 ,39,240,247,169,0, 
133,0,133,2,168,170,169,16,133,1,169,163 

230 DATA1 33, 3, 177, 0,1 70, 177, 2, 145, 0,1 38, 145, 
2 , 230 , 2 , 230 , , 208 , 240 , 230 , 3 , 230 , 1 , 1 65 , 1 
240 DATA201 ,30,203,230,234,182,45,185,0,162, 
1 53 , 45 , , 1 38 , 1 53 , , 1 62 , 20 , 1 92 , 1 8 , 20 8 , 239 
250 DATA234,! 69, 147, 141, 11 9, 2, 169 ,76, 141, 120, 

2.169.201.141 .121 .2.169.13.141.122.2.169.4 
260 DATA133, 198,88,76, 191 ,234,-1 



MEMORY BLK: 

Or Memory Block, is a group of memory 
locations. For our usage in this text, we 
will refer to a BLK as a group of 8k ( 8k = 
8192 ) memory locations. 



PORT: 

A point at which the internal workings 
of a computer can send information to or 
receive information from the outside world. 
The VIC-20 has several "PORTS" including the 
USER PORT, the GAME PORT and the MEMORY 
EXPANSION PORT, (also see slot) 



RAM: 

Random access memory (RAM for 
the type of memory that you wil 
store your programs. It is "volati 
means it can be erased. It can be 
altered, as you wish. For exampl 
poke a RAM location (POKE 4099 , 
peek at it (? PEEK (4099)), you 
back what you put in. But if you 
off and on again, your number wil 
So RAM changes as you instruct it 
your programs and data. 



short) is 
1 use to 
le", which 
changed or 
e, if you 
117) , then 

will get 
turn power 
1 be gone. 

to store 
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ROM 



Read Only Memory, (ROM for short) , is 
the opposite of RAM in that it cannot be 
erased or modified by you and your VIC, ROM 
is used to store pre-programmed games and 
utilities. For example, there are ROMs in- 
side your VIC-20 that contain 
basic language you use for 
Other programs like the VIC 
AID" cartridge come to you on 
program that comes in a plug-in cartridge 
format will be in ROM. These ROMs will take 
up space in your VIC's available memory, 
for example, a ROM might be assigned by its 
designer to work in BLK 5. If you have any- 
thing in that block, it will have to go. 

SLOT: 



the entire 
programming. 
"PROGRAMMERS 
ROMs. Any 



In normal use a slot is the same as a 
port. For our use in this manual we will 
intend a slot to mean one of the three fe- 
male connectors (where you plug in car- 
tridges) on the "CARDBOARD/3". These are the 
electrical equivalent of the "MEMORY 
EXPANSION PORT" in the rear of your VIC-20 



PAGE A2 



'CARDRAM/ie* - APPENDIX 



PROGRAM SWAPPER 
*************** 



This program also uses RAM memory in 
BLK # 5 and your system should be set up as 
in the last example. In this program we will 
allow you to store two basic programs in RAM 
BLK # 5. and call either one for use when 
ever you need it. There are several limita- 
tions to this program due to the limited 
amount of space available in this manual, 
however it could be expanded to eliminate 
all of these limitations. 

The programs you intend to use must be 
able to run on an unexpanded VIC-20. And you 
must be sure not to have any RAM memory in 
BLK # 1. To use this program just do the 
following: 

1 - Type in the program as shown. 

2 - Save the program for future use. 

3 - Run the program. 

4 - Type SYS 41216 (RETURN) 

5 - Load or type in your first program. 

6 - Press function key "F-l" 

7 - Load or type in your other program. 



You 
memory, 
either 
all you 
For exam 
poke var 
and lea 
trieve, 
here is 
imaginat 



now have 
You can run 
program. To 
need to do i 
pie, you can 
iables into 
ve them for 
and lots o 

a good ch 
ion and expe 



two basic programs in 

, edit, save or whatever 

swap to the other program 

s press the "F-l" key. 

write your programs to 

unused areas of memory 
the other program to re- 
f other cute tricks. So 
ance for you to use your 
riment a bit. 
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MACHINE LANGUAGE SCREEN SWAP PROGRAM 
************************************ 



10 REM E.J. LIPPERT II 

20 X=48896 

30 READ A: IF A=300 THEN GOTO 50 

40 POKE X,A : X=X+1: GOTO30 

50 POKE 36879, 110 :PRINT "CLR/HOME 
CTRL/WHITE" 

60 Get A$: IF A$ = "" THEN 60 

70 IF A$ <> CHR$ (133) THEN PRINT A$; :GOTO60 

80 IF P=l THEN P=0: SYS 48936: GOTO 60 



90 P=l: SYS 48896: GOTO 60 



100 DATA 16 
110 DATA 24 
120 DATA 18 
130 DATA 0, 
140 DATA 16 
150 DATA 24 
160 DATA 18 
170 DATA f 



2,0 f 189 
7,189,0 
9,0,163 
164,157 
2,0,189 
7,189,0 
9,0,161 
162,157 



,0,30,157 
,31,157,0 
,157,0,30 
,0,31,232 
,0,30,157 
,31,157,0 
,157,0,30 
,0,31,232 



,0,16 
,162, 
,232, 
,208, 
,0,16 
,164, 
,232, 
,208, 



1,23 
232, 
208, 
247, 
3,23 
232, 
208, 
247, 



2,208 

208,247 

247,189 

96,234 

2,208 

208,247 

247,189 

96,300 



MOTE: This program can be expanded to store 
several screens and can use a for/next loop 
to do the swap instead of the function key. 



APPENDIX OF USEFUL INFORMATION 
****************************** 

PROGRAM TO RELOCATE THE SCREEN 

By: E.J. Lippert II 

10 POKE 8192,00 

20 POKE 44,32 

30 CLR 

40 POKE 648,30 

50 POKE 36866,150 

60 POKE 36869,240 

70 FOR I = 217 TO 228:POKE J,158:NEXT 

80 FOR I = 229 TO 250:POKE I,159:NEXT 

90 PRINT "CLEAR/HOME" 

99 NEW 



NOTE: This program must stand alone. It 
cannot be part of another program 
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THE USE OF RAM MEMORY IN BLK 5 
a-***************************** 

Even if BLK 5 cannot be accessed by 
basic for programming, it can be a very 
useful warehouse for data. For example, you 
can peek at each location of the screen RAM 
and poke the entire screen into BLK 5 for 
safekeeping and recall it at any time. You 
can do this with the screen color RAM, tool 
There is enough room in BLK 5 to store 16 
complete screens, or 8 screens with color 
information. This can be done with simple 
basic programming. However, if you used a 
machine language sub-routine to store and 
recall the screen, it would happen so fast 
that you wouldn't even see it change. This 
is how some arcade games achieve animation. 

BLK 5 can be used to store any kind of 
data. In a program I wrote recently, which 
was to be used as a message center, each 
message was stored in BLK 5 and then re- 
trieved as it was requested by the program. 
The messages could then be changed at will 
without alteration to the basic program. 
This also allowed over 8000 bytes of message 
storage without using any of the VIC-20's 
valuable basic programming area. 
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But remember .. the only access to BLK 5 
is through the basic PEEK/POKE commands, or 
machine language programming. In fact, the 
entire 8k can be used to store machine lan- 
guage programs and/or sub-routines. And that 
is exactly what the VIC Super-Expander car- 
tridge is... it is a bunch of machine lan- 
guage sub-routines (in ROM) stored in BLK 5. 



The following programs 
some uses of BLK 5 RAM. The 
and store two screens of information. Set 
requires that the "CARDRAM/16" have one 
RAM BLOCK assigned to BLK 5 (dip switch 
on) . The other block switches may be off 
selected to any block other than block # 5 



will demonstrate 
first will swap 
up 
8k 
#5 
or 



Press reset 
disk) the progr 
program. Type 
"f-l" function 
garbage. Clear 
more information 
again, and you 
the first scree 
switch to go f 
This system can 
screens using 
real perfection 
process to sto 
it's location a 
with the screen 



, enter (and save on tape or 
am as shown. Load and run the 
in something then press the 
key. The screen will show 
the screen, and type in some 
Now press the "f-l" key 
will see what you typed in on 
n. The "f-l" key is now a 
rom one screen to another, 
be used for as many as 16 
just BLK 5. And if you are a 
ist you can use the same 
re the color information from 
t 37888 into BLK # 5 along 
RAM data. 
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